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Chapter One 
Introduction 



The Xerox 1100 Scientific Information Processor (better known as a Dolphin, or sometimes, DO) is 
a personal workstation capable of emulating a number of target architectures, such as the Xerox 
Alto,^ and the Mesa and Interlisp Virtual Machines. The Dolphin is equipped with a 23 megabyte 
Winchester disk for local storage, a 1024 by 808 bitmapped display, a 3 megabit Ethernet interface 
and at least 2304 512-byte pages of MOS memory (with a large virtual address space). 

This manual will discuss the responsibilities of tlie site manager for a Dolphin installation njnning 
the Interlisp-D language. Interlisp-D is the implementation of the Interlisp language for the 
Xerox's D-series machines (this includes the Dolphin, the Dorado, and future processors). 
Interlisp-D is fully compatible with Interlisp-10 and Interlisp-VAX, but has die added power of 
bitmapped display graphics not available in these other Interlisp implementations. 

In addition, the Interlisp-D I/O system makes full use of the capabilities of Ethernet file transfer 
protocols. Files can reside either on die local disk or on a file server accessible via the Etliernet. 
Paged and random-access I/O can be perfoiTned on both local and remote files. 

Other References 

This guide provides only a cursory overview of the Alto operating system, and does not attempt to 
describe Interlisp at all. For more complete information on the Alto system, refer to The Alto 
User's Handbook, Interlisp is documented in The Interlisp Reference Manual, Those parts of 
Intcrlisp-D not defined in tlic basic Interlisp language are documented in the Interlisp-D Users 
Guide. An excellent introduction to the LiSP language is found in LISI\ by Patrick Winston and 
Rcrthold Klaus Paul Morn. The 3 mbit/sec Ethernet is documented in a number of Xerox 
internal memos, as well as a small number of published papers. Xerox should be able to supply 
copies of tliese papers. 



u\c Alio is nn cnrly Xerox personal coinpuier, based on the Hula General Nova. It has a 600 by 800 point bilinapped 
display, a local disk drive, and a connection to the cxpcrinienial 3 Megabit I'lhernet. 'Ilie Alio sened as Ihc basis for all 
facets of Xerox's jicrsonal workstation development including processor, software, and perhaps most importantly, 
l.lhernet develo|mient. llic Alios arc comparatively slow machines, but ihey are still around, and the software developed 
for them is still in use in machines which einulaie Altos. 
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^. ^ , Chapter Two 
The Dolphin Hardware 



Tlie configuration of a Dolphin mnning Interlisp-D typically contains: 

oThe processor, containing ALU, control store, memory controller, miscellaneous 
flmctions, memory, disk, terminal, and Etliernet interface boards. 

• The local disk, currently a Shugart 4008 Winchester-style disk. 

o The keyboard, display, and mouse. The display is a 1024 by 808 bitmap arranged in 
landscape (horizontal) mode. Tlie mouse is a pointing device to aid in interactive 
graphical programming. 

Dolphins come in three styles depending on their vintage of production. The original Dolphins 
were built at Xerox PARC and are encased in Alto boxes. These are small units with the Shugart 
disk built-in, and invisible from tlie outside. The "pre-production" Dolphins were built at 
Xerox's HI Segundo plant and are actually tlie front end processors for their 5700 series laser 
printers. These are larger, louder machines, with the Shugart disk placed in its own box sitting on 
top of the processor box. Finally, tlie production model Dolphins are once again small units 
(smaller dian the PARC models) widi carefully designed acoustical padding to make them 
acceptable in an office setting. 

Despite dieir varied appearances, however, all Dolphins are electrically and operationally 
compatible. Most PC boards and all programs can be swapped between units. 



The processor box 

The Dolphin's central processor is composed of four boards: the control store, ALU, 
miscellaneous functions, and memory controller boards. These boards always occupy die first 
four slots in die motherboard."^ See figure 2-1. Furdiermorc, each board has a specific slot within 
these four locations, and is keyed to prevent its being installed in die wrong slot. The rest of die 
PC boards can go almost anywhere in die motherboard (memory boards must reside in slots 5-12) 
so long as no gaps exist between boards. 

The fiont panel of die processor box contains die ON/BOOT and 01^1^ switches, as well as a 4 
LF,D maintenance panel. The ON/BOOT switch uirns die processor on, and later (on a second 
push) boots the processor, once the disk has warmed up. The maintenance panel (MP) displays 
various information about die state of die processor. The meanings of die various numbers are 
detailed in Appendix 111. When the processor is first booted, the MP displays the number of 
pages of physical memory available. While running Intcrlisp, the MP displays a cunuilaUve count 
of page faults since starting Interlisp."* 



3 . 

I'ar lii^ht on iho prc-produclion model, looking into tlic back oflhc unit; top-to-bouoni on the production uniLs. 

4. ^ . 
i nis may have changed by the lime you read this document. 



Dolphin Site Manager's Guide 



Page 3 



(FRONT) 




PRODUCTION DOLPHIN (SIDE VIEW) 



ETHER MEM LTVFC RDC MEMC MISC ALU CS 




PRE-PRODUCTION DOLPHIN (REAR VIEW) 



Figure 2-1: Backplane configuration for pre-production and production Dolphins 
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In ilic following, references to the tops and bottoms of die PC boards are meaningful for the pre- 
production model of the Dolphin, in which the boards are mounted vertically from tlie rear of the 
processor box. 

The rigid disk controller (RDC) board allows tlie Shugart disk to emulate a dual* model 44 Diablo 
disk. This permits software developed for the Alto to be used with tlie Dolphin. There are two 
cables linking die RDC board with tlie disk. The cable terminated in tlie small plug is plugged 
into the upper of tlie two small sockets on the rear of tlie board. 

The terminal controller board (UTVFC in Xerox terminology) links the keyboard and display 
with the processor. Tlie cable to the display should be plugged into the topmost of tlie four 
sockets on die board. The display can be as far as 250 feet from the processor. 

There are usually six memory boards, each containing 96K 16-bit words of memory. When the 
Dolphin is booted, the maintenance panel on die front of the Dolphin records the number of 
pages of memory available. This should read at least 2304. If less dian that (frequently in quanta 
of 384 pages, Uie capacity of one memory board), at least one memory board is failing. Interlisp- 
D can usually run with 1920 pages of memory (one memory board failing), but its performance 
will be poor. The Dolphin can be configured with a maximum of eight memory boards. As you 
might expect, its performance will be better with more physical memory. 

The Ediernet Interface connects die Dolphin to a 3 Megabit Ediernet. There is a single cable 
leading from die interface to the Ediernet transceiver. This cable can be about 40 feet long. 

A typical procedure for tracking down hardware failures is to swap PC boards with a working 
Dolphin. Make sure die processor is powered off when changing boards; severe component 
damage will result if you do not. 



The Keyboard, Display, and Mouse 

The keyboard/display/mouse station is linked to the processor via a seven twisted-pair cable. As 
previously noted, this cable can be up to 250 feet long; however, at these distances, the screen 
image may be corrupted by line noise. If you attempt to remote die display by diis much, you 
must adhere to die cable specifications as provided by Xerox; a low-loss, high bandwidth cable is 
required. Be sure you have not crossed die twisted pairs; to do so sometimes produces quite a 
pyrotechnic display behind die screen! 

If you remote die display unit, you may have to adjust a timing delay circuit located inside the 
display base. To do this, remove die back of the display base. Attached to die back is a small PC 
board labelled "7-Wire Interface." Sitting on top of the PC board is an ungainly LRC circuit. 
This circuit must be adjusted to match the characteristics of die cable between die display and die 
processor. If misadjustcd, the display will appear to fragment. Adjust the variable capacitor until 
die screen image appears whole again. Once you reassemble die display, you may find die 
adjusuiicnt of the i.RC is off slightly due to its being installed within die base; if diis happens, try 
again. 

The mouse is a useful device which permits die user to point to any location on die screen. The 
mouse currently in use has a large steel ball on its underside. Motions of the mouse across a 
surface arc translated into X and Y components and dicn transmitted to die processor. The 
mouse performs best if placed on an unpolished surface. Paper is generally not a good surface to 
run the mouse on, diough, since paper fibers can jam up the precision mechanism inside die 
mouse. The best surface is a Uiick iiibbcr mat (Xerox calls dicm "mouse traps"). 



Dolphin Site Manager's Guide Page 5 

The keyboard is a 63 key unencodcd keypad. Because the keyboard is unencoded, die Dolphin 
can read any number of keys simultaneously, and also give arbitrary meaning to any key. Within 
Interlisp-D, however, the keyboard is treated like a standard CRT keyboard. 

Notice tlie set of three unlabeled keys on the right side of die keypad. The lowest key is known as 
die SWAT key, and when used in conjunction with the left SHIFF or CONTROL key, allow you 
to intermpt Interlisp and return to die Alto operating system or enter die Alto debugger 
respectively. This is not a good idea, as you may destroy the Interlisp environment, but you may 
need to resort to this in case of software or hardware problems which hang Interlisp. 



The Local Disk 

The local disk is built into die processor box on the PARC and producdon model Dolphins, and 
sits on top of the processor box in die pre-production models. As mendoned above, there are two 
cables amning from the disk to the disk controller in die processor. A third cable connects to a 
power supply within die processor, as well. The disk should be maintenance free, however, you 
may need to replace a disk which has developed hard disk errors, rendering it unsafe to use. 

Replacing a Disk 

To replace a disk, first unplug all cables leading to it. Gain access to the top of the disk (remove 
the cover of the disk box on the pre-production model). There are two locking devices you must 
install before moving die disk. The first of these is a head restraint. There should be a plastic 
"fork" in or near die Dolphin. This should be placed under die head motion damper (the circular 
fixture at die rear of die disk with die yellow caution labels) around die head pivot to prevent die 
heads from moving during U'ansport. Do diis while die disk is powered up.^ The second lock is a 
small screw which locks the belt drive, preventing die disk from spinning. There is a yellow 
caution label with an arrow pointing to die place where die screw goes (on the black plastic guard 
surrounding die drive belt). Rotate die drive pulley by hand (clockwise only!) undl die screw 
hole comes into view. Install die screw and dghten undl firm. 

To remove die disk from its box, unplug all cables leading from die disk fixture to die box, and 
loosen the screv/s on die four legs which fix the disk to its case. Remove the disk and put die 
replacement disk in its place. Connect die necessary plugs, remove die drive locking screw and 
the head damper lock, and plug the cables from the disk drive into the processor. Put die cover 
back on. Power the Dolphin up and listen for the usual sounds of die disk drive. If things sounds 
wrong, double check what you've done, and call Xerox if necessary. If the disk sounds OK, you 
may sdll have to reinstall die Interlisp software. See page 15. 



Yes. po'.vcrcd-up!. Shuiinrt says that while spinning, ihc head lloals above the disk, and it is impossible to damage the 
head in case inserting ihe damper restraint causes Lhe head (o move. 
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^ Chapter Three 
The Alto Software 



Dolphin software falls into two categories: tliat which is necessary to am tlie Alto emulator, and 
tliat which is necessary to run Interlisp. A freshly-booted Dolphin runs an Alto emulator. The 
Alto emulator is necessary because many of tiic lowest-levels of I/O in die Interlisp environment 
rely on BCPL routines written for the Alto. When amning only die Alto emulator, die display 
will appear narrow, masked to die dimensions of an Alto screen. The Alto also provides a 
filesystem. In die Dolphin, your filesystem appears to spread over two separate pardtions of a 
dual Diablo model 44 disk drive. The two disk pardtions are isolated from one another; to switch 
between pardtions, give die Pardtion.-' command (e.g. type Partition 1 or Partition 2). 

Tlie Alto command processor (die Alto Executive) has a syntax reminiscent of die Tenex/Tops-20 
Exec. Interlisp users should have litde use for the Alto emulator, aside from stardng Interlisp, but 
die Dolphin site manager should be familiar with the Alto Execudve and operadng system, as 
several diagnostics (notably disk diagnostics) must be invoked using Alto commands. 



Alio Executive Commands 

Commands to die Alto Execudve can be abbreviated, and recognidon is available using the ESC 
key. File names and commands are treated identically by the command processor. There are no 
special characters in Alto file names; ".'' has no significance in a fde name. However, commands 
to die Alto Execudve are signified by ending in ".--'' (i.e. Copy.-). Filenames and commands can 
be a mixture of upper and lower case; however, all command and filename lookup is done in a 
case independent manner. When entering commands or file names, several special characters can 
be typed: 

? Type out file names or commands which fit the pardal name/command typed 

in so far. Return to command/file name input afterwards. 

TAB Like *'?," except diat the command input buffer is cleared after lisdng die file 
names or commands which match what had been typed in. TAB typed to a 
blank field is the way to see die names of all die files on die disk and all die 
Executive commands. 

tX Control-X. Expands any wildcards entered so far, replacing dicm by all the file 
names which fit die wildcard mask. lH)r instance, if files I^'OOl and F002 exist, 
and you type "DliLini- lOO*" followed by tX, the command line is replaced by 
Din.fni-: Fooi I^^oo?., allowing you to abort die command in case a file you 
didn't mean to delete is among the wildcard group. 

DEL Aborts the command, returns to command input. Like tU on Tops-20, DEL 
on vanilla Tcnex, tX on Sumex Tencx, etc. 

BS Backspaces one character. 

ESC Attempts to rccogni/.e and complete input typed so far. If ambiguous, fills out 
as far as it can. 

Alto Executive commands to know: 
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Copy.-- Copies a file on the disk. The syntax is not Tenex/Tops-20-hkc. To copy a file, 

type Copy.'- NewFileName <— OlclFilcName, 

Delete.-- Deletes files on die disk. Type one or more filenames, separated by spaces: 

Delete- filelfilel ...Qtc... fileN, 

Install.'- Causes tlie Alto operating system to enter a reconfiguration dialogue. The 

"short dialogue" allows you to set a default username, a disk name, and 
whether a password is needed to use the machine. The disk name should 
identify which partition of tlie disk is in use (i.e. call partition one Partition 1 
and pardtion two Partition 2). Dolphin users may desire that a password be set 
to prevent unauthorized use of the machine. You should know these 
passwords in case you have to diagnose failures when no one who knows the 
passwords is around. 

The long installation dialogue allows you to erase the disk and completely 
reinstall tlie Alto and Interlisp systems. This may have to be done periodically 
when new releases of Interlisp come out, as well as when you are installing a 
new disk. The long installation dialogue cannot be performed unless you have 
another Dolphin accessible over tlie Etliernet running die Alto FTP program, 
or unless you have access to a larger file server iimning programs compatible 
with the Xerox 3 Megabit PUP software (specifically, the Byte Stream Protocol 
based File Transfer Protocol). Appendix I contains die long install procedure. 

Login.-- Tells tlie Alto operating system your name and password. Inteiiisp-D uses Uiis 

when it attempts to do file transfers over the Ediernet. If you forget to login at 
die Alto level, diere is a LOGIN function in Interlisp to do die same diing. If 
you are reinidalizing Interlisp (see page 11), you should give the Login.*- 
command first so diat Interlisp knows whose INIT.LISP file to look at when 
running die GlllZET fimction. 

NetExec- If your Dolphins are connected to a 3 Megabit Ediernet which has a file server 

with net boot capabilities, you can give the NetExec command. This causes die 
Dolphin to boot die NetExec, a special network-oriented Executive stored on 
die file server. The NetExec in turn lets you boot other programs from die file 
server. The NetExec gives you access to diagnostics (DiEx, CRlTest, KeyTest) 
and filesystcm verification and repair programs (Scavenger) you may need to 
keep your Dolphins running. 

Partition.- Allows you to switch between pardtions of the disk. 

Rename.- Renames a file on die disk. The syntax is like Copy.- (see above). 

Scavenger.- Boots the Scavenger program via the Ediernet. Scavenger is a filesystcm repair 

program which can undo damage caused by a crash. Instructions on its use are 
in The Inlcrllsp-D User's Guide, 
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Alio Files and Programs 

There arc a number of files critical to tlic operation of the Alto emulator and Alto operating 
system. If any of these files arc deleted, you won't be able to boot your Dolphin. This can be an 
insunnountable problem if you don't have tlie necessary 3 Megabit software running on your file 
server to reinitialize die Alto software from scratch. 

Files needed for tlie Alto OS: 

DiskDescriptor. Defines die filesystem format. 

Executive.Run This is die Alto command processor. 

Swat. This is the Alto debugger. A crashed Alto usually ends up in Swat, giving you 

some indication of what went wrong (i.e. disk error, trap instiuction, etc). 

Swat.Help A list of Swat commands, readable by Swat, giving you online help when you 

type "?." 

Sys.Boot This is the Alto operating system. 

Sys.Errors A text file used by Swat to translate between internal error numbers and 

human readable messages. 

SysFont.al .AL files are font files for Altos. SysFont.al is die font used by die Executive 

and other Alto programs. 

User.cm A text file, defining preferences for various user-settable options in the 

Executive and other Alto programs. 

Alto programs come in two flavors, run files and boot files. Run files can be invoked from the 
Alto Executive. They usually have the .Run extension, and when you quit from such a program, 
you are returned to die Executive. To invoke a run file, type its name to the Alto Executive, 
followed by any optional arguments (see die reference to CreateFile.Run, for instance, on page 
12). 

Boot files, on the odicr hand, cannot be invoked directly from the Alto Executive (they can on an 
Alto, but the Dolphin has the wrong type of disk for die Alto Bootfrom.-- command to work). 
Boot files can be invoked by the NetHxcc, diougli (see above). When a program in a boot file 
quits, it usually returns you to die NetExec program. As dicir name might suggest, boot files 
replace die endre Alto operating system. Any information you've told die Alto operating system 
about yourself (i.e. your name, using the Login. *- command) is lost when you mn a boot file. To 
invoke a boot file, type its name to die NetExec program. You cannot supply arguments with a 
boot file, however. 

In the list below, programs available only as run files or boot files are so indicated by their 
extension; programs available in bodi forms are listed without any extensions in dieir names. 

Useful Alto Programs: 

Chat The Alto virtual terminal program. You may have diis program (you will if 

you arc at a University Grant site or you've convinced Xerox to let you have it) 
or you may not. There's also DMChat, which simulates a 60 line high 
Datamedia 2500 CRT. 

CrcatcfilcRun Creates big empty files using contiguous disk space. This is the way to create 
Intcrlisp-D's virtual memory buffer when you are reinstalling die interlisp-D 
system. 
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CRTIcstJioot Useful for checking display linearity. Type any character to switch to the next 
sized grid. 

DiEx.Root The Diablo disk exerciser. Run this program if you suspect disk problems. 

DiEx has many options which can be set by selecting an option with the mouse 
and entering new values. For most purposes, it suffices to set the disk*type to 
Diablo 44 (point to Type: Mod-31 and press the left mouse button), initialize 
(point to Init Verify and press die left mouse button), and ain the test (point to 
Do Test and press a mouse button). DiEx will report hard and soft disk errors, 
giving tlieir sector, track, and head numbers. For more customized diagnosis, 
look at some of the other menu items in DiEx (they are self-documenting; 
simply point at an item with the mouse, and read the message in the message 
window). A more rigorous diagnosUc is available in the BFSTest program, 
documented in Appendix I. 

The Alto RSP based file transfer program. If you have Chat, you'll probably 
have FTP. If your file server isn't amning a reliable Leaf server, it may be 
mnning a reliable FFP server (implementations exist for Tenex, Tops-20, and 
Unix, as well as for the Xerox Alto-based Interim File Server). 

Reinstalls the Alto debugger. You must run tliis after erasing die disk with the 
long installation dialogue. 

Useful for checking tlie keyboard. Self-explanatory. 

Scavenger is a file system repair program. When your Dolphin falls into Swat 
with an error message telling you that Uiere's something wrong with the disk, 
try running Scavenger. Scavenger takes about 5 minutes to run. When it's 
done, it leaves a log called Scavenger.LogS telling you what it's done, and 
creates a file called Scavenger.Garbage$ which contains "incorrigible disk 
pages." You may delete Scavenger.Garbage$ with the Delete.-- command. If 
your disk has hard read errors (caused perhaps by surface damage on the disk). 
Scavenger will map Uicm out of existence. 



FTP 



InstallSwat.Run 

KeyTest.Boot 
Scavenger 



The Alio Net Bool Procedure 

This information is included for sites with 3 megabit Ethernet software wishing to add or 
understand the Alto net boot protocol. The Alto net bootstrap does tlie following: 

1. Broadcasts a MayDay Pup to all miscellaneous service sockets on die connected 
network. The ID field of the Pup contains die boot file number of the file to be 
booted. 

2. PiCcomcs an I'FFP receiver. A server which receives the MayDay request and can 
satisfy it opens an Hl-TP socket, and begins sending the boot file to tlie Alto or 
Dolpliin. if two servers or more can satisfy a boot request, the bootee locks onto the 
first one which responds, and ignores all others (space limitations within the Alto 
prevented tlie inclusion of code to send Abort Pups to other responding servers); the 
other servers will eventually timeout. 

Of course, the above description presupposes an E.thernet bootstrap in memory. This may not be 
the case. It is possible to boot an Alto or Dolphin with a blank memory (i.e. one which has no 



Sites running a Scavenger predating May 12. 1982 should :ls1c for an update. 
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working disk to load a bootstrap from) by means of the Dreath-of-Life mechanism. Every five 
seconds, a Breath-of-lJfe server will broadcast a special packet (not a Pup, but a raw Etliernct 
packet of type 602n, directed to host 377b). An Alto or Dolphin wishing to be booted will copy 
tliis packet into main memory, starting at location 1, and begins executing code starting at location 
3. The packet may be no longer than 254 words plus 2 words of Ethernet encapsulation. ^Breath 
of' Life is a block of Alto code which supplies enough information for the Alto or Dolphin to read 
Uie next block of code, which is found on tlie second page of tlie boot file. From there, an EFTP 
connection serves to transfer the rest of the boot file from the server to the Alto or Dolphin, where 
packets are copied into main memory. 

Even with the limited program space in the Alto bootstrap, it is possible to select which boot file 
you wish loaded. When the bootstrap starts, it reads a value from the unencoded keyboard, and 
places Uiat value in tlie ID field of die MayDay Pup. Certain keyboard combinations are well 
known: holding down die BS key enables Ediernet booting; if BS is the only key held, boot file 
(DMT, die dyanamic memory test) will be loaded; if BS and ' (Quote) are held down, boot file 10, 
die NetExec, will be loaded. 

When booting a Dolphin, die mechanism becomes even more complex, as Alto-emulator 
microcode must be loaded. When die Dolphin has a working disk, this micrcode is loaded from a 
set of special tracks shared between partitions, and not writeable during normal operations. When 
die Dolphin has no disk (or die disk hasn't wanned up yet), it tries to load microcode from the 
Ethernet. This microcode boot is similar to an Alto net boot, except that instead of using EFTP to 
move die microcode, the microcode boot server simply sends die code in Pups one after another, 
wiUiout waiting for acknowledgement. 

The Tencx/Tops-20 Pup server job has die ability to perform both Alto-style and microcode-style 
boots, but cannot send Brealh-ofLife packets (Tencx/Tops-20 Pup service can send only Pups). 
The VAX/Unix Pup service currently supports Breath-of Life ^nd Alto boot, and should be able 
to support microcode boot with minimal effort 
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^^ ^ ^. Chapter Four 
The Interhsp-D Software 



The Interlisp-D environment is comprised of a number of files. Chief among these are the 
Interlisp microcode loader, bootstrap, sysout, and virtual memory buffer. There are a number of 
ancillary files, such as Interlisp-D font files and Lispusers packages. 

To am Interlisp, first boot the Dolphin. When die Alto emulator is running, and you're looking 
at the narrow Alto screen, mn the program DolphinLispMC.Run. This loads the Interlisp 
microcode. As a result, the screen expands to its fiiU width, and die Alto Executive returns. You 
may now start Interlisp-D. If Interlisp has been used before in tliis partition, the file 
Lisp.VirtualMem contains a runnable image of Interlisp, and by typing Lisp, you will restart this 
image. If Lisp.VirtualMem is empty (Lisp has never been run before, or you've just refreshed the 
disk), type Lisp/i. This causes the Lisp bootstrap (Lisp.mn) to fill Lisp.VirtualMem with a 
runnable image of Interlisp taken from die Interlisp sysout file, Lisp .sysout. 

Lisp takes a minute or so to load. When it's ready, you'll by sitting at Interlisp's top level, 
EVALQT. To leave Interlisp, evaluate Uie fimction LOGOUT. The next time you start Lisp, you'll 
be returned to tiie Interlisp environment at the point you logged out. 

Files Needed to Run Interlisp-D 

The follov/ing is a list of files which must reside on your disk to am Interlisp-D: 

DolphinLispMC.Run 

A mnnable program in Alto operating system format which loads die Interlisp 
microcode. 

Init.Lisp Interlisp-D configuration file. Defines the search path for Lispusers 

directories, user greetfiles directories, etc. Read when die GRF.irr function is 
evaluated. This file is comparable to the site Init.Lisp in Interlisp-10. 

Lisp. Run The Intcrlisp-D bootstrap program, again an Alto format runnable file. If you 

type Lisp to the Alto Executive, Intcrlisp-D will be started from die 
environment stored in Lisp.VirtualMem. This is the way to continue an 
Interlisp session ended by LOGOUT. 

If you type Lisp/i to die Alto Executive, die Interlisp environment will be 
loaded anew from Lisp.sysout. This is the way to reinitialize liucrlisp-D. This 
takes a bit of time, however, so be patient. When die hourglass cui-sor reaches 
die bottom of die screen, initialization is complete. 

If you type \a^) filename, the Interlisp environment is loaded h'om ftlenanie ti 
file produced by the Intcrlisp-D SYSOUT fimction. Note: die previous Interlisp 
environment stored in 1/isp.VirtualMem v/ill be lost. If your filcserver has a 3 
Megabit Edicrnct BSl^-bascd FIT server, you can load a sysout over die 
Iidiernet by typing Lisp {/lostmwic} filename, where hoslncunc is your file 
server's name on the Edicrnct. 

Lisp.Syms An Alto-format symbol file for Lisp. Run. If your Dolphin falls into Swat, you 

may be able to continue running Lisp by calling RAID from Swat. To do so. 
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type RaidtC (Raid followed by tC) to Swat. The first time you enter Swat, 
however, IJsp's symbols may be unknown. To make diem known to Swat, 
type tVLisp.Syms^. 

Lisp.Sysout The basic Intcrlisp environment, used to initialize Lisp.VirtualMem. 

Lisp.VirtualMem The virtual memory buffer. This file should be 8000 decimal pages long, and 
works best when allocated contiguously. The Createfile program, mentioned 
above, can be used to create Lisp.VirtualMem. To do so, type Crcatenie 
Lisp.VirtualMem 80001) to tlie Alto Executive. To ensure the availability of 
8000 contiguous pages, tliis file is best created after refreshing the disk. 

Files which must be resident on disk or accessible via a file server: 

*.DCOM Compiled Lispusers packages. 

'♦'.Strike Interlisp-D font files (Gacha and Helvetica fonts). 

Fonts.Widths Defines font sizes for Xerox fonts. 



Configuring Interlisp-D 

When Interlisp-D is started up for the first time (after reinitialization, for example), it evaluates 
the Greizt function. This causes it to read die file Init.Lisp on die disk. Figure 4-1 is a sample 
disk Init.Lisp. 

(* This is the Stanford system greeting file.) 
(VARS (DEFAULTPRINTINGHOST (QUOTE TAHOE)) 

(LISPUSERSDIRECTORIES (QUOTE ({LASSEN}<LISPUSERS> 

{LASSEN}<DOLPHIN>LISPUSERS> 
{SUMEX-AIM}<DOLPHIN> 
{DSK}))) 
(FONTDIRECTORIES (QUOTE ({DSK} {LASSEN}<ALTOFONTS>) ) ) 
(USERGREETFILES (QUOTE (({LASSEN}< USER >LISP>IMIT .DOOM) 

({LASSEN}< USER >LISP>INIT) 
({LASSEN}< USER >INIT.DCOM) 
({LASSEN}< USER >INIT.LISP) 
({SUMEX-AIM}< USER >INIT.DCOM) 
({SUMEX-AIM}< USER >INIT.LISP) 
({DSK}INIT. USER] 
(FONTWIDTIISFILES (QUOTE ({DSK}FOMTS .WIDTHS 

{LASSEN}<FONTS>FONTS .WIDTHS) ) ) 
(DIRECTORIES (QUOTE (MIL {LASSEN}<LISPUSERS> 

{LASSEN}<LISPUSERS>LISP> 
{LASSEN}<DOLPHIN>LISPUSERS> 
{LASSEM}<DOLPHIN>LISP> 
{SUMEX-AIM}<DOLPHIN> 
{DSK}))) 
(ALTMARROWBACKGROUNDSHADE 42330)))) . 
STOP 

Fi;;iire 4-1: A sample disk resident IM r.LlSP. 

This file defines the default primer for Lisliil.liSl to be TaiioI' (Stanford's Dover printer), and 
dien defines a number of directory search paths. LlSPLSi-RSDlRllcrORll'S is searched when a 
ITI.I-S command from a COMS list specifics another file to load (i.e. FILES FROM VALUEOF 
LISPUSERSDIRECTORIES ...). i'ONTniiM:CTOiui:s is searched looking for Strike files. 
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Usi-RGRHiiTFiLns Is scarchcd looking for the uscfs personal init file (see below). 
FON'rwiD'riisriLJ'S is searched looking for Fonls.Widths. Finally, DniiiCrORins is searched by 
die FiNDi-iLE function. Altnarrowbackgroundshadc is an alternate texture (see die 

Inlerlisp'D Users Guide) for die background of the Interlisp-D windows system. 

* 

The GRCirr ftinction also looks up die user's personal init file. Tlie list USERGRF.ETFILES defines 
where to look for this file. Pack* is used to build each candidate filename, with User bound to 
die value of Username. The Dolphin sets Username by looking into die Alto OS. Username is 
inidally the name specified when die operating system was instxilled (with die Instant- 
command). The name can be changed by giving die Login.-- command. Figure 4-2 shows a 
typical personal init file. 

The important diing to note in personal init files is diat they can be used in many different 
Interlisp environments. (SELECTQ (SYSTEMTYPE) ... ) is used to choose options based 
on the implementation of Interlisp being run. In this file, for instance, when running Interlisp-10, 
<XxMYClN>T'lTlN.COM is loaded, and all control characters (except tY) are made separators. 
When Rinning Interlisp-D, die TrviN, display editor, and data inspector packages are loaded, and 
the window system is turned white on a black background. 



7. 

'llic Inner allows prcilyprinlcd output with font cliangc characters embedded to bo read. Intcrlisp-D produces such 
files by default with Maki ru.a 
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(E (RESETSAVE CHANGECHAR NIL)) 
(DECLARE: FIRST 

(P (SELECTQ (SYSTEMTYPE) 

((TENEX TOPS20) 
(SETSEPR (QUOTE {%] 1 2 3 4 5 6 7 8 9 10 
11 12 13 14 15 16 17 18 
19 20 21 22 23 24 26)) 
1 FILERDTBL) 
(JSYS 34 64) 
(SELECTQ (PEEKC T) 
((% %tj) 
(CLOSEF (INPUT)) 
(SETQ USERNAME NIL) 
(GREETO) 
(RESET)) 
NIL) 
(QUOTE <XMYCIN>TTYIN.COM) 
(QUOTE SYSLOAD))) 
(SETQQ USERNAME SCHOEN) 
(VIDEOCOLOR T) 

(CHANGEBACKGROUND WHITESHADE) 
(LOAD? (QUOTE TTYIN.DCOM) 
SYSLOAD)) 
DEDIT.DCOM) 
SYSLOAD)) 
INSPECT. DOOM) 
SYSLOAD))) 

Unknov/n system type")))) 



(LOAD? 
(D 

(LOAD? 
(LOAD? 



(VARS 



(PRINl 



(QUOTE 
(QUOTE 
(QUOTE 
(QUOTE 
(QUOTE 
INIT.LISP; 



#nPARS PROMPT^yPLG (FIRSTNAME "Eric") 

(CLEANUPOPTIONS (QUOTE (RC))) 

(CLISPIFYENGLSHFLG NIL) 

(HARDCOPYFLG) 

(ADISOFILE) 

(DISPLAYON) 

(MSPRINTFLG 1) 

(CHECKUNSAVEFLG T) 

(COMPILEMODE (COND 



(ALTO NIL) 
(EMACSFLG T) 
(SHOWPARENFLG T)) 
(APPENDVARS (DIRECTORIES 



((BOUMDP (QUOTE COMPILEMODE)) 

COMPILEMODE) 
(T (QUOTE PDP-10)))) 



STOP 



NIL {LASSEN}<LISPUSERS> 
{SUMEX-AIM}<LISP>) 
(LISPUSERSDIRECTORIES {LASSEN}<LISPUSERS> 

{SUMEX-AIM}<LISP>)) 
(ALISTS (FOrJTDEFS PARC)) 
(ADDVARS (IMITIALSLST (SCHOEN . ejs:))) 
(P (FONTSET '(QUOTE PARC] 



Fijjiirc 4-2: A typical personal Intcrlisp init file. 
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I. Reinstalling a Disk Partition 

The long form of the Install.^ command allows you to completely erase and rewrite a disk 
partition. You must only attempt this if you have access to 3 Megabit Ethernet software! The 
following procedure will completely erase your disk partition, and then rewrite the Alto OS, 
Executive, and FIP program. The Alto files will be FlT'ed from the host you specify in the 
procedure. This can be a large file server, such as an IFS or timesharing machine running PUP 
software, or it can be another Dolphin. If your server for tliis procedure is a Dolphin, then enter a 
blank line in the question below asking for the name of die directory where Alto files are kept. In 
tlie example below, it is assumed Alto files are kept in a directory named Alto. Make absolutely 
sure all important files arc safely stored on another machine! 

The disk refresh procedure requires a server supporting the Alto boot protocol be nmning 
somewhere on your Ethernet. Some file servers, such as the Sumex-Tenex and DECsystem-20 
PUPSRV program, and the Xerox IFS support tlie Alto boot protocols. If your file server doesn't, 
and you have at least one running Dolphin, you can turn that Dolphin into a boot server by 
running the Peek program on it. Refer to page 16. 

Before reinstalling a disk partition, you may nm an overnight disk exercisor. This is wise if you 
suspect hardware problems within die disk. The instmctions immediately following this 
paragraph tell you how to run tlie disk exercising program. If you believe tlie disk is sound, skip 
them, and proceed to step 2 for instructions on rewriting a disk partition. 

l.To run the exercisor, you need a boot server with BFSTest.boot. From the Alto 
executive on tlie machine you wish to exercise, in tlie proper partition, type NetExec 
to boot the NetExec program. Then type BFSTest to invoke tlie disk exercisor. Do 
the following: 

^Partition 1 (or 2, whichever you want done) 
♦Ccrtifyj How many passes? 100 

Use both of the disks? Y 

Use all 406 cylinders of the disk? Y 

Use all 14 sectors of the disk? Y 

Note: It seems Certify sometimes does not give you the option of 406 cylinders, and 
assumes 203 instead. If tliis occurs, run NewOs as described below first, and tlicn am 
BFSTest. 

* Krase 

Use both of the disks? Y 

Use all 406 cylinders of the disk? Y 

Use all 14 sectors of the disk? Y 
*K\crcisc^ How many passes? 10 
♦Quit 

2. Quiting returns you to tlie NetExec program. Now reinstall the software on the disk 
by running the NcwOS program. If you have not just exercised the disk with 
BFSTest, and arc instead just reinstalling the software, get to the Alto F:xccutive and 
type Install. 

3. Respond to the following dialog as follows: 
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Do you v/ant the long installation dialog? Y 

Do you want to ERASE the disk . . .? Y 

Type the name of a host to get Alto programs from: hostname^ 

Type directory name vyhere Alto files are kept; Altoj 

Include DPI in file system? Y 

Use all 14 sectors of the disk? Y 

Do you want a big SysDir? Y 

When the disk is ready type OK to proceed, A to abort. OK^ 

Take a short coffee break, and pray that you have previously saved all your important 
files somewhere else. 

Do you want to disable error logging through the net? Y 
What is your name? Whatever you >Yant for your default name j 
Please give your disk a name? Partition 1 or Partition 2j 
Do you wish to give your disk a password? Y or N^ 

If you answered yes, then 

Please type the password: Choose your password j 

At diis point in time the machine, should connect with tlie host and retrieve 
Executive.Run and Ftp.Run. It will dicn return you to the Executive with a clean 
disk. 

4. Now retrieve InstallSwat.Run and Sys.Errors. Then am InstallSwat.Run. After it is 
done delete InstallSwat.Run, Dmt.Boot, and Dumper.Boot. Next retrieve 
CreatcFile.Run and type the following to the Exec: Crcatcfilc Lisp.VirtualMcm 
8000(1 (takes about 5 min.) 

5. Next bring over the appropriate lisp files and anything else you might need. The 
following procedure is die one used within Stanford to refresh Dolphins, and reflects 
the network topology and directory stmcture within the Computer Science 
Department and the SUMilx-AiM project. These retrieves arc best done with die Alto 
FIT program (FTP.Run). A newly refreshed disk will have a nmnablc FfP program. 

a. Retrieve Lisp. Run, Lisp.Syms, L/isp.Sysout, and DolphinLispMC.Run from 
{lFS}<Dolphin>lisp> (i.e. file server host IPS, directory Lispusers, subdirectory 
lisp). If die IPS isn't available, these files can also be retrieved from {SUMHX- 
Aim}<Dolpihn>. 

b. Retrieve *.SrRlKnand Imt.Lisp from {lPS}<Lispusers>. 

c. Confirm that I.Jsp runs by initializing it via I.isp/i. 

If you need to create your own temporary boot server, you can do iim die Alto Peck program on 
anoilicr, working, Dolphin. There are two files you need in addition to the boot files, 'lliese are 
Peek. run and PcckUser.cm. You should rename the file User.cm to some other file name (i.e. 
Rename.-- OUser.cm f- User.cm), dien copy PeekUser.cm to be User.cm. Then run die Peek 



8,, .. 

lion ( i\pe a carnaL'c roluin! Install doesn't wail lor your carriage return, and if you do type one. you will have ended 
lip suppl>ing a null password for the disk, which is a fatal mistake, as you will never be able to Uy^, in. if by mistake you 
end up supplying a null password, you'll h.a\e to reinstall the opcralinij .^yslem via die Neii-xcc and New OS; this time, 
don't erase the disk. 
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program. The Dolphin running the server program must have tlic necessary boot files on its disk. 
For the above procedures, you need NcwOS.Boot and BFS'rcst.Root. When you are done, 
rename OUser.cm back to User.cm. 
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IL Recovering From Disasters 

Sooner or later, someone is going to delete the wrong file, or the disk will develop a few hard read 
errors in die wrong places, or something similar, and your Dolphin will be unusable. Typically, 
you'll boot tlie machine, Uie maintenance panel will flash Uic standard disk boot sequence (40- 
700-720-ctc), but when the Alto-sized display lights up, the cursor won't track with tlic mouse. 
Tliis indicates that ilie Alto software is hung somewhere due to a bad or missing file. Unless you 
have access to a file server with complete booting service (Breath-of-Life and net boot), call 
Xerox. If you do have booting software on your file server, diere is still hope. 

The first program to mn is Scavenger (the boot file version, of course). To do this, you must first 
run tlie NetExec program. Since you can't mn the Alto Executive to give the NetExec.~ 
command, you must get NetExec in another way: hold down simultaneously tlie BS and ' (Quote) 
keys, and press the boot button (try first the one behind tlie keyboard, and if that fails, the 
Start/On button on the processor's front panel). Continue holding tlie keys until the Alto-sized 
screen appears, with a small randomly-filled square sitting in the center. This square represents 
the acknowledgement packet for tlie EFIT transaction taking place to boot the Dolphin (with 
NetExcc.boot); it is stored in the cursor memory to save on critically-short memory space during 
booting. In short order, the booting process should end, and the NetExec program should start. 
Select tlic fluilty partition with tlie NetExec's Partition.'^ command, and type Scavenger^, and die 
booting process should repeat itself, completing diis ume with die Scavenger program nmning. 
Answer Scavenger's questions and cross your fingers. If it wants to rewrite a page, let it. On its 
completion, Scavenger will attempt to boot into tlie current disk partition. 

If die Dolphin still won't boot, try reinstalling die operating system. To do diis, obtain die 
NetExec as described in the previous paragraph, and select the desired disk pardtion. Type 
NewOS j, and wait for die booting to end. Answer qucsdons as in die following dialogue: 

Do you want to install this operating system? Y 
Dov you want the long installation dialogue? N 

Follow die iiistiiicdons in Appendix I to complete the installation. When NevvOS finishes, it 
should have supplied you with a new operating system, default font, and Executive. You may 
have to repeat die enure procedure a couple of umes, in case die disk surface is badly damaged, 
and NewOS has trouble finding good pages to install itself on. If you still can't get die Dolphin to 
boot, reinstall the faulty pardtion, following die instnictions in Appendix I; you probably should 
also check the condition of die disk with cidier DiEx (page 9) or BFSTest. 
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III. Maintenance Panel Codes 

llie following Is a list of maintenance panel codes transcribed from some unnamed Xerox 
document. Complete accuracy is not guaranteed. 

M V Codes from Rev L Eproms 

0000 One of the first few instaictions in tlie Eprom clears the MP. 

0001 The first few ALU tests worked OK. You should never see tliis, since some 
other error should happen or tlie MP should change to 0040 when RDC 
booting starts. 

0002 Midas boot (Midas is the hardware debugger). 
0004 to 0015 One of the preliminary ALU tests failed. 

0016 Mismatch after write then read of an R register via the stack. 

0017 The contents of an R register have changed. 

0020 to 0035 A fault happened. The MP contains 20 plus the contents of the Parity register. 

A fault in tlie fault handler will reBoot the machine, so you may not get to see 
these codes. 

0020 A Breakpoint micro instruction (Fl = Group, B, F2 = 7) was executed. 

0021 Memory error. Since the Eprom code doesn't use main memory, this is 
probably an H4 Parity error. 

0022 R register parity error. 
0024 Control Store parity error. 

0022 and 0024 are to be expected if you have just powered up your machine (The bias on 
the RAM chips hasn 7 been pumped up yet). This will invoke a one minute delay to avoid 
hogging the boot servers when something is broken. Poke the button again if you want 
faster service, 

0028 Stack error. 

0040 Starting to load microcode from RDC. 

0041 Can't find RDC (Will now try to EUierBoot). 

0042 Hardware error while reading. 

0043 Seek timed out. 

0044 Microcode checksum error. 

0045 Bad Control Store address - attempt to load into HPROM area. 

0046 Disk not ready (Will now try to I'therBoot). 

0047 The label word which should contain a link to the next page of microcode to be 
loaded has an invalid disk address. 

Most disk errors (0042, 0041 0044, 0045, 0047) can be caused by simple transient read 
problems. The RDC task simply retries all of them while the emulator task is counting 
down a tinwr. If the timer runs out, you will see 0043, 

OO^^S Didn't load microcode from RDC within one second (Will now try to 

lithcrBoot). 



Dolphin Site Manager's Guide Page 20 

0060 Starting to load microcode via Edicrnet. 

0061 Can't find Ediernct board. 

0062 Bad microcode checksum. 

0063 Bad Control Store address - attempt to load into EPROM area. 

0064 Hardware error (bad status) at end of packet. 

0065 Timeout after 15 tries at about 10 seconds each. 

If EtherBooting doesnl work, the MP will slowly alternate between 006x and 004 x so 
that you can see both what is wrong with the disk and what is wrong with the Ethernet. 

0070 to 0085 An unexpected wakeup happened. Tlie MP contains 70 plus the number of the 

offending task. 

0071 Unexpected wakeup for task 1. 

0072 Unexpected wakeup for task 2. 

0073 Unexpected wakeup for task 3. 

0074 Unexpected wakeup for task 4. (Task 4 is used by tlie RDC and for Ethernet 
output.) 

0075 Unexpected wakeup for task 5. 

0076 Unexpected wakeup for task 6. 

0077 Unexpected wakeup for task 7. 

0078 Unexpected wakeup for task lOB. (Task lOB is used for Ethernet input). 

0079 Unexpected wakeup for task IIB. 

0080 Unexpected wakeup for task 12B. 

0081 Unexpected wakeup for task 13 B. 

0082 Unexpected wakeup for task 14B. 

0083 Unexpected wakeup for task 15 B. 

0084 Unexpected wakeup for task 16 B. 

0085 Unexpected wakeup for task 17 B. 

If you get one of these, one of the 10 controllers is probably broken. For example, its 
reset logic is not working, or the wakeup logic on the RDC or Ethernet board is 
generating the wrong task number, 

MP Codes from the (Oct 80) CSL microcode (Alto mode) 

0100 Start Map Init. 

0101 Not enough memory (You need 192K = 2 boards). 

0102 Bad map. 

Olio Start Device Init. 

0115 Start Ethernet Init. 

This is what you will sec during and after booting the net exec from the Ethernet. 

0120 Start Disk Boot. 

This is what you will sec after you have booted from the disk. 
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0121 Timeout waiting for disk status. 

0122 Hardware error reading disk (after 10 retries), or ALU is too hot. 

0128 R parity error. 

0129 Real breakpoint. 

0130 Map out of bounds. 

0131 H4 parity error (The microcode ignores dicse if they come from task 7, 
Ediernet input, unless you have set a flag from Midas). 

0132 H4 parity error and Map out of bounds. 

0133 MC2 error. 

0134 2 MC2 errors. 

0135 MCI Fault when emulator not ready. 

0136 Fault from instaiction following LoadPage. 

0137 Stack Error (when emulator not ready). 

0138 Control Store parity error. 

MP Codes from Mokolumnc Initial 

0700 Start Map IniL 

0701 Not enough memory (Initial requires 64 K). 

0702 Bad Map. 

0720 Starting to load emulator microcode from disk. 

0721 NoRDC. 

0722 RDC Read error. 
0725 Starting to boot Pilot. 

0728 R or CS parity error. 

0729 Real breakpoint. 
0737 Stack over/underflow. 

0739 Generic memory error. 

0740 Starting to EtherBoot. 

0741 Can't find UTVFC (or Tor display controller). 

IVhcn Initial starts Ftlierbooting, it puts 7^0 -h 2''*'bfn into the MP (BFN is the microcode 
boot flic number). IfEtherLoadcanl load thatfde within a reasonable length of time, it 
will give up and bump the MP by one), 

07-12 ami 07^14 are from the Amargosa version of initial, 

0758 IVyingtoloadAltoLF.eb 

0759 Timeout trying to load AltoLF.eb 

0760 Trying to load AltoCSLeb 

0761 Timeout trying to load AltoCSL.eb 

0S09 Pilot microcode not installed on SA4000 (Try to F-lhcrBoot). 

0810 Germ not installed on SA4000 (Try to l-thcrBoot). 

0811 Physical Boot \\)lunic not set on SA4000 (Try to llherBoot). 
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0812 Label check from SA4000 (Try to Etlicrnoot). 

MP Codes from Mokohiinnc (Pilot) Microcode 

0140 Running Pilot (Tor kludge). 

0710 Start device initialization. 

0727 R register parity error. 

0728 CS parity error. 

0729 Real breakpoint. 

0730 Map out of bounds. 

0731 H4 parity error (The microcode ignores these unless you have set a flag from 
Midas). 

0732 H4 parity error and Map out of bounds. 

0733 MC2 error. 

0734 2 MC2 errors. 

0735 MCI fault when emulator not ready. 

0736 Fault from insanjction following LoadPage. 

0737 Stack error (when emulator not ready). 

0846 Running Pilot (this was die last value before tlie Tor kludge was added). You 

won't normally be able to see tliis since the Germ smashes tlie MP to 0900 as 
soon as it gets a chance. 

MP Codes from the Hardware 

8808 R parity error. 

8880 CS parity error. 

8888 Lamp test (while die boot button is down). 
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